Skip to content

docs: add CLAUDE.md and REVIEW.md for Claude Code integration#82

Closed
coryyeakelacdc wants to merge 11 commits intoShopify:mainfrom
acadaca-shopify:feature/claude-review-config
Closed

docs: add CLAUDE.md and REVIEW.md for Claude Code integration#82
coryyeakelacdc wants to merge 11 commits intoShopify:mainfrom
acadaca-shopify:feature/claude-review-config

Conversation

@coryyeakelacdc
Copy link
Copy Markdown

Summary

  • CLAUDE.md: Project context, commands, architecture decisions, and conventions for Claude Code sessions. Keeps Claude productive without repeating information already in existing docs.
  • REVIEW.md: Comprehensive code review guide for Shopify theme development covering Liquid, JavaScript, CSS, accessibility, performance, SEO, security, and theme editor compatibility. Intended as the universal standard for all Acadaca themes — client repos inherit this and can add a REVIEW-local.md for store-specific rules.

Test plan

  • Review CLAUDE.md for accuracy against current project state
  • Review REVIEW.md sections for completeness and appropriate strictness
  • Confirm no sensitive information included in either file

coryyeakelacdc and others added 11 commits February 17, 2026 14:17
Copied from Shopify Horizon commit a6a3484ce86dea3810290bad9c475847ba504c86
Skeleton base commit 04069e0

Copied:
- 94 blocks, 52 sections, 116 assets, 95 snippets
- Templates, config, locales, layout (Horizon replacements)
- Dual license attribution (LICENSE-SKELETON.md, LICENSE-HORIZON.md)
- Architecture and execution plans (.planning/)
- Source provenance (HORIZON_VERSION.md)

Zero modifications - vanilla copy for v1.0.0.
11 original Skeleton sections were unreferenced by any template
and caused 31 theme check errors due to missing locale keys
(Horizon's locales replaced Skeleton's). All have Horizon
equivalents that templates already use.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- package.json: @acadaca-shopify/acadaca-core-theme@1.0.0 with GitHub Packages registry
- README.md: replaced Skeleton's with agency core theme docs
- CONTRIBUTING.md: replaced Skeleton's with agency dev workflow
- CHANGELOG.md: v1.0.0 release notes with source provenance
- PRUNING_STRATEGY.md: block usage tracking and annual review process
- .gitignore: added *.tgz

Tested: npm pack (938kB, 421 files) -> test install -> shopify theme check
passes with same 2 upstream Horizon errors as source.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
chore: add npm package configuration and documentation
Publishes to GitHub Packages on version tag push (v*).
Uses built-in GITHUB_TOKEN for authentication.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
These were inherited from the Shopify/skeleton-theme fork and require
Shopify-specific secrets (CLA_TOKEN) and permissions that don't exist
in our org. Removes merge blockers on PRs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Prevents accidental commit of npm auth tokens.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Documents what belongs in core vs client repos, contribution workflow,
versioning rules, publishing process, upstream tracking strategy, and
how client updates work.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
CLAUDE.md provides project context, commands, architecture decisions,
and conventions for Claude Code sessions. REVIEW.md is a comprehensive
code review guide covering Liquid, JS, CSS, accessibility, performance,
SEO, and security for Shopify theme development.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant